home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / asmutil / asmhelp.zip / READ.ME < prev    next >
Text File  |  1987-10-30  |  3KB  |  74 lines
  1. The files contained in this archive were created by:
  2.  
  3.             Michael Kesti
  4.             823 Zion St.
  5.             Nevada City, CA.
  6.                 95959
  7.  
  8.             Home Phone: 916-265-8513.
  9.             Work Phone: 916-478-3620.
  10.             UUCP: !tektronix!gvgpsa!gvgspd!mrk
  11.  
  12. They are intended for the use of any persons who find them useful and are
  13. to be considered public domain.  The author will attempt to answer any
  14. inquiries concerning their use and/or accuracy, and invites users to inform
  15. him of any problems discovered.
  16.  
  17.  
  18. The following files are included:
  19.  
  20.             BIOS_DOS.DOC
  21.             BIOS_DOS.INC
  22.             EQUATES.INC
  23.             COM.ASM
  24.             EXE.ASM
  25.             SBR_HDR.TPL
  26.             MAKECOM.BAT
  27.             MAKEEXE.BAT
  28.             MAKEIT.BAT
  29.             MAKESYS.BAT
  30.  
  31. They were written to facilitate the creation of assembly language programs
  32. for IBM-PC and compatible computers running PC-DOS or MS-DOS using the
  33. Microsoft MASM assembler.  Their use not only speeds writing such programs,
  34. but adds a degree of consistency to them that aids the programmer in reusing
  35. routines from previous programs without having to alter symbolic references,
  36. as a "standard" symbology is then used in all programs.
  37.  
  38. BIOS_DOS.DOC is a text file that documents the ROM BIOS and DOS services
  39.     available to these computers.  It is intended to be used as a
  40.     reference while writing programs and details the calling sequences
  41.     for these services.
  42.  
  43. BIOS_DOS.INC is an include file that symbolically defines the interrupt and
  44.     function numbers of these services using the same symbology as that
  45.     in BIOS_DOS.DOC.
  46.  
  47. EQUATES.INC defines a number of symbols commonly used in assembly language
  48.     programs for these computers.
  49.  
  50. COM.ASM and EXE.ASM are templates for programs intended to be .COM and .EXE
  51.     files, respectively.  They provide the overhead required by MASM and
  52.     a "standard" source file format, and free the programmer from having
  53.     to reproduce this text for each new program.  The INCLUDE directive
  54.     is used to include BIOS_DOS.INC and EQUATES.INC.
  55.  
  56. SBR_HDR.TPL is a "standard" subroutine header.  Its use promotes good
  57.     documentation practices by providing a form into which the
  58.     programmer may define the calling sequence of new routines.
  59.  
  60. MAKECOM.BAT, MAKEEXE.BAT, and MAKESYS.BAT are batch files that perform the
  61.     required MASM, LINK, and EXE2BIN calls required to translate source
  62.     files to executable .COM, .EXE, and .SYS files, respectively.  They
  63.     assume that MASM, LINK, and EXE2BIN are either in the current
  64.     directory or on the PATH.  They further assume that source files use
  65.     the extension .ASM, and output a list file with the extension .LST
  66.     and an executable file with the extension .COM, .SYS or .EXE.  Upon
  67.     completion, all intermediate files are deleted.  For example, to
  68.     convert the source file FOO.ASM to a .COM file, use: 
  69.  
  70.         MAKECOM FOO
  71.  
  72.     When it is finished, MAKECOM.BAT will have created files FOO.LST and
  73.     FOO.COM and deleted FOO.OBJ and FOO.EXE.
  74.